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INTROIUCTION TO THE OS-9 USER'S GUIDE 


Welcome to the world of CS-9! If you are new to microcomputers 
you will be learning in an almost ideal environment. If .you are 


an “old hand 4, you are about to be introduced to the most modern 


microcomputer Software development technology. In either case, we 


hope you will have many hours of nappy computing. 


-OS-S is one of the results of a three-year project to develon 
a family of software to fully exploit the extracrdinary 
performance of the Motorola 6829 Advanced 68-bit Microprocessor. 
The design goal cf the OS-9 project was to produce a state-of- 
the-art, extensitle, real-time operating system, with particular 


emphasis on Suppor? for modular ROMed software. These goels were 


not only met, but several important 05-9 features, especially 
those relating to ‘memory modules , represent e significant step 


x TOF Kara in microcomputer software technology. 


The Motorola 6389 microprocessor and ©OS-9 is the first. 


coordinated hardware/software system that can take advantage of 


the versatility and cost-effectiveness of the “software on. 
Silicon concept demanded by the complex microcomputer 
applications of the eighties. 


We hope that these new tools will play an important part in 
making your job easier. | | | 


-= 0S-S's "Parent Processes": 


Larry Crane 


Bob Doggett 
Larry French 


Ken Kaplan > 


Doug Nicholson 
Bill Phelps 


Terry Ritter 
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Introduction 


This guide is designed for persons who will be using an  OS-9 
system. for general interactive applications on a single-user or 
timesharing system. It is both a tutorial and a reference book. 


Persons who will be using 05-9 for different applications or who 


will write assembly-language programs should refer to the  "0$-9 
System Programmer’s Manual for detailed information on the 
capabilities and inner workings of 03-9. 5 


0S-9 has powers far above and beyond those of "ordinary 

Operating systems. In order tc reap the most tenefit from the 
many advanced features of 0S-9, please read this entire manual 
through at least once before using 0S-9. This is particularly 
true for those who have worked with other microcomputer operating 
systems, since it may be necessary to un-learn some of the 
things that were previously thought impossible. P 


OVERVIEW OF OS-9 


OS-9 can be used in many ways and forms, from a small "kernel" 
in ROM used to control a machine tool, ur to a fully-equipped 
timesharing system used in businesses, laboratories and schools. 
This versatility is one of 0OS-9's major advantages and 
distinguishes it from many other operating systems. Ir 


“particular, OS-9 software is portable upward or downward, so. 


you can develop small system software on a big system, or vice 
versa. 


.0S-9 is available in two versions: Level Cne is for smaller 
systems that have up to 56K of memory, Level Two is for systems 


. having up to a megabyte of memory. From the user’s point of 


view, both levels behave almost identically and the informatior 


in this guide aprlies to either version except where otherwise 


noted. 
Some of the main features of OS-S are: 


ls True multiprogramming capabilities. Expensive computer 
resources may be shared amoung several users with a minimal 
effect on program performance. A single user may run 
several programs simultaneously, long programs need not tie 

up the computer for extended periods cf time since they may 

pe run as background processes leaving the computer ready to 

run another program. : 


2. Most OS-9 systems support “type ahead" which allows sou to 
continue typing even though the computer is in the middie of 
processing the previous command. : : 7 
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Š. Active support for modular Software, particularig:20Ned 
software, which will play an increasingly importantcrole::i 


the future as a way to reduce software costs. Modules E 


be dynamically linked together or unlinked at run time. 
Memory iS managed in much the same way aS a disk.crA module 
directory is malntained which contains information about the 
latest revision of each module in memory including its 
address, location, size, etc. ROMed . modulés.-: p 
automatically ea and entered in the module E 
4. Hierarchical file Systen; A file directory may Fé iéteated 
for each user,.group, project, etc. Files which aré-féiated 
to each other may be placed in a directory of :their‘own, 
thus making it easier to manage large numbers of files. 
Directories may even contain sub-directcries. as 


5. Unified I/O system.| Devices are used as if they were data 
files. Programs treat files as a sequence of bytes, upon 
which any structure may be imposed. ) 


E I/O redirection. JA. program's standard I/O pathszmay ‘te 
redirected to any device in the system at run-time£c-.- THis 
means that it is inot necessary to "tie" a program to.a 

specific I/O device or port. For example, the output: of à 

C> program may be redirected to a disk file if a printer is 

S "^ o busy, then some time later when. it^ becomes availatle the 
file may be listed to the printer. EXE RU 

E The "shell" deu interpreter which executes interactive 
commands from a terminal provides easy use of otherwise 


complicated functions such as multitasking, I/O redirection, 
memory allocation, etc. vom 


HOW TO INSTALL OS-9 ON DISK BASED SYSTEMS 


Because there are versions of OS-9 customized for many xinds 


of 6809 computers, this section describes a general installation 


procedure. Specific instructicns for your version of 05-9 is 
supplied with the software on an installation sneet (for the OS-9 
hardware requirements, please see the system preeremeres 
manual). | i | 

EXPERIENCE HAS SHOWN THAT MOST PROPLZ MS OCCUR WEEN ASSUMPIICHS 
ARE MADE ABOUT ue ADDRESSES, SWITCH SETTINGS, ETC. 


Please read the T lation sheet carefully, aud. check ALL 

wor hardware addresses. Make sure that the interrupt | jumpers. or. 
gris | |. Switches are enabled cn all I/O interfaces. Also make sure that 
1 the baud rates on the interface para MeS EES the baud rate of the. 
systems terminals. Ñ | 
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SYSTEM STARTUP 


To start the system, simply turn the computer on: the master 
disk drive select light should light up almost at once. Insert 
the OS-9 system disk in the drive and close the door. 95-9 will 
load a number of modules into RAM memory, then display a startup 


message on the system console terminal within several seconds. 


If this does not happen, reset the computer. If the system does 
not come up within 22 seconds, turn the computer off and re-check 
the hardware setur. 


WARNING: Never turn power on or off while disks are loaded in 
drives. | | 


After the shell prints the 'OSO: ^" prompt, the system is 


ready and waiting for you to enter a command. You should use the 


'SETIME" command (if your system uses a real-time clock) to start. 
the clock running. 0S-9 cannot perform multitasking (time 
slicing) until you have done this. | | 


If the system is being installed for the first time, you 
should use the FORMAT command to initialize a tlank diskette, 
then use the BACKUP command to create a mirror image of the 
system disk received from Microware (the criginal should be kept 
for archival purposes). You may want to create the system 
password file (see LOGIN command). If the system is to be usta 


for timesharing, you should also create a shell procedure file ~ 


for system start-up which runs the “TSMON command for each 
terminal to be used. The startup file is an ordinary procedure 
file and may use any of the shell commands. : 


NOTE: If you want to create a system disx used for start up 


purposes, you must either use the BACKUP command to maxe a mirror 
image of an. existing system disk, or make sure that the new disz 


has been set up as follows: 


EN a bootstrap file must have teen installed in the new disk 
with the COBELER or OSOGEN commands. The COPY command can 
not be used to install a bootstrap file. 

2. There must be a Shell procedure file ERE "/D@/startur™ z 


S. There must te an initial command directory | called 
/D@/emds . 
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How you start "talking" to OS-S depends on which terminal you 
are using. If you are using the system console , or if your 


System has only one terminal, you will be communicating~ ‘with "à 


program called the "shell It is called the “shell because a 
shell is what surrounds the kernel of a seed: “kernel 15s the 
name used to describe the core of the operating system. < TR ese 
names are descripive of the multi-layered nature of 05-9; e M ei 
If you are using a terminal other than the system console you 
may have tc 'log-on which involves entering a correct user 
number and password before you can talk to the shell. When you 
log in, you must use the user name and password that was: 755512 ned 
to you. An example cf the log-in procedure is shown belog ieni: 


OS-9 Level 1 Timesharing System Release 1.2 18/05/60 bte 


err 


User neme?: Bot a See T | E T 
Password: open Sesame | a 


User #3 logged 18/85/80 12:34:29 
Shell | 
039: 


If you don’t enter e valid user name or password, the message 
"ho will te displayed and you will te asked to reenter ther. 


You have three chances to enter them correctly. You can shorten 


the login procedure ty typing your user name and passworó on tae 
Same line. | 


O0S-9 is a very complex operating system that has many powerful 
capabilities. The shell exists to provide an interface "tetween 
you and the kernel which is easy and convenient to use, without 
limiting your ability tc fully utilize the computer's 
capabilities. On the other hand, machine-languaze programs 
communicate directly with the kernel using service requests" 


which are 68@9 machine-language instructions. The shell’s (and. 


command programs’) function is to provide most of the S 
services, using command lines cf. English-like words thet 
easier for people to use and understand. 


R 
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if it is not already in memory. 
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The shell operates by accepting a command line entered from 
your keyboard and executing it. You will know when tne shell is 
waiting for inrut because it always displays the prompt 0S9: | 
You respond by tyring a command line and carriaze return (which 

should always be the last character omn a line). For example, the 


command. to run BASICZ is this: 


OSS: BASICOS 


If you make a mistake while typing, you can use the 
“backspace” key (CONTROL-H on most keyboards), or you can delete 
the entire line using the "line delete" key (usually CONTROL-X). 
There are several other control keys that have functions as 
listed below. Note: it is possible to redefine wHich keys 
corresrond to these functions: see the TMODE command description. 


“py Gio pe e 


Terminal Control Keys © Ue ie ipe 


CONTROL A - Repeat previous input line. The last line ‘entéred 


will be redisplayed. After it is disp layed, you may correct it 
and then enter a carriage return to execute it. EN - 


CONTROL C - Program Interrupt. eT. T 


CONTROL D redisplay present input line 


CONTROL H - Backspace | ust 


CONTROL Q - Quit Program | | | 
This key can be used to abort execütion of command programs 
(which returns you to the shell). 


CONTROL W — display wait | 
This control key will temporarily halt data output to your 
terminal So you can read the screen before the data scrolls off. 
Output is resumed when you hit any other key. 


CONTROL X - line delete 


ESCAPE (CONTROL [) - End- of-File 

This key is used to send an end-of-file to programs that read. 
input from the terminal in place of a disk or tape file. It must 
be the first character on the line to be recognized. 


Fach shell command line begins with the name. of a program, 
woich can be followed by one or more opticnal "parameter" words 
or symbols. These ere used to describe names of files or devices 


te be used by the program, or to activate optional functions or 


features. 


-— ew e P 


The shell does not actually execute t the command itself: what 


actually cccurs is a particular program is called to perform the 
prog 


desired function. The program will be loeded from diss oF tare 
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AN INTRODUCTION TO MULTIPROGRAMMING 


OS-S is a multiprogramming (sometimes called “multitasking’) 
operating system. that has the ability to execute a numter of 
independent programs ("processes") at the same time. Each process 
is independent and kas its own memory space. 05-9 handles all 
communications between a process and the outside werld. It also 
manages and allocates the three primary shared resources: memory, 
CPU time, and input/output devices. - 


The CPU is interrupted ty a "real time clock” many times every 
Second. This is a basic time interval called a tick’. At. any 
occurance of a tick, OS-9 can suspend execution of one program 
and begin execution of anotner. The starting and stopping of 
programs is done in such a way that they are not affected and run 
as though they ere rot being interrupted. 


Zach “runnable” program shares the MPU with shes rent vie: 
processes. How often a process gets a time slice depends upon. 
its priority relative to Other processes and events in the 
system. | 


This technique is called "'time-slicing" because each second of 
CPU time is sliced up to be shared among several processes. This 


. happens so rapidly that to a human observer all processes appear 


to execute continuously, unless the computer becomes “overloaded” 
with processing. If this happens, a noticeable delay in response 
to terminal input may occur, or "batch" programs may take much 
longer to run than they ordinarily do. | 


CPU time is a limited resource that must te allocated wisely 
to maximize the cemputer’s throughput. It is characteristic of 


many programs to spend a lot of unproductive time waiting for 


outside world events. A classic example is a program waiting for 


a line of input to be typed on a keyboard and srending 99.999% of 


the time waiting for a (relatively) slow human to hit keys. Ir 
order to avcid wasting Pane: hr Ean are classifed into one of 


| 
ACTIVE PROCESSES are those which have useful work to. do. and 
are included ia the REE 
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WAITING PROCESSES are suspended pending occurance of some 
event, usually completion of an input. or output function, or 
a message from another process. 


SLEEPING PROCESSES are suspended vy self-request fora 
specified time interval. | in. 


Sleeping and waiting processes are not given CPU time HaT they 


are activated by sore signal or event. 


CREATICN OF NEW PROCESSES s | A. 


New processes are created when an existing process executes: =a 
0S-9 service request called "fork One of the parameters’ Passed 
in “fork is the name of a program ‘module the new process is to 
initially execute. The program can already be present in memory, 
or 0$-98 may load it from a mass storage file “having. the “same 
name. The shell’s main function is to read an input line and 
perform a "fork on the command (program) name given. Thisrrleads 
to some important points atout the shell: suoBpplize c2 


^ a se mo -— Me au apr 
US m ep, C ltegun X wx 


i.There is ncthing special atout the shell: it is just 
enotner program as far as OS-9 is. concerned. It is reentrant 
and Many), seperate incarnations of the shell can” exist at 

any given time. JE iut : gU oO ee ea 


2. The programs invoked by the shell are — NEW 
PROCESSES | that are capable of independent, concurrent 
executicn. prd 


$. The shell usually suspends itself from execution until 
termination of the program (process) it invoked.: Then it 
wakes up, outputs another prompt. gets another input line, 
and performs | another "fork". This loop repeats until end- 
of-file is detected on its input device, or the shell 
process is killed by external means. 


bay process can create aS many new processes as it wants, 
limited only by the amount of ai memory available. to load 
and Tun new processes. . erates 

When processes create new processes, which in turn «create 
additional new processes, a hierarchical lineage becomes evident. 
In fact, tnis hierarchy is a tree structure that resembles a 
family tree. The family concept makes it easy to-:descrite 


relationships tetween processes, and sc it is used extensively in 
descrirtions of OS-9's multiprogrammirg cperations. | 


When a process creates a new process, the original process is 
called. the ‘parent process and the newer process is called the 
“chile” process. If a parent process creates more than one child 
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process, the children are called "siblings" with respect to each 
other. Of course, the children car create their own children: and 
become parents um ad infinitum. Terminology--sSuch. as. 

‘grandparents and reat~erandparents may be appropriate but 
are seldom, used because we are usually mcre concerned with ie 
| G than the “ancestors. | Br E ae 


wa 
tk 


Om 


PROCESS INITIALIZATION AND INHERITANCE 7 LN ees tees 


When a process executes a fork service reauest, | 05-9 then 
takes over and starts the new process creation sequence. If any 
part of the sequemce cannot te performed the fork is atorted and 
the prospective parent is notified. The most frequent reason for 
failure is when required resources such as memory or 1/0 devices 
are not available at that instant. © pr S 


08-85 first step is to attempt to locate, the-:fequested 
rrogram module by searching the "module directory”, whieh Has: the 
name and type of every module already present in memory. The 

€809 instruction set supports a tyre of program called: fresatrünt 
code" which means the exact same copy” of a prozgram-*canttbe 
shared try two or more different processes simultaneously without 
affecting each cther, provided that each incarnation of the 


" 
M 


program has an inderendent memory area for its variables; -S 


Tage eo 
pan d 
Me e i C 


Most Microware O5-9 family software is reentrant and D one 
makes most efficient use cf memory. For example, the Macro Text 
Editor is about 5K in size. If you call for this program and 
some other user (process) has already caused it to be loaded, you 
will execute the sare copy instead of loading another copy into 
an additional -5K cf memory. OS-9 always keeps track of how many 
processes are using each program module end deletes the module 
(freeing its memory for other uses) when the last user is 
finished with it. E | EL C. ie 


If the requested program module is not already in memory, the 
name is used as a vathlist (file name) and an attempt is made to 
load the program from mass storage. | | | 


Every program module has a "module header that descrites the 
program and its memcry requirements.  CS$-98 uses this to determine 
how much memory for variable storage should be allocated to the 
process (it, can te given more memory ty specifying an optional 
parameter on the shell command line). The module header alsc 
includes other important) descriptve information about the 
program, and is an essential part of OS-S operation at the 
machine langauge level. A detailed decrirtion of memory modules 
and module Ga can be on in the "OS-g eem prog sme ^s 

Manual’ LEL 


| 
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When a new process is created 0$-9 — it a e process 
. ID code which is a numter in the range cf 1 to 255. It [is -also 


allocated the amount of memory space needed for its: “extlusive - 


use. The new process also inherits” some things from its 
parent: | 


1. A USER NUMBER which is used for file security and to 
identify processes belonging to a 2 sg user. This is 
not the same as the process. ID. which. identifies a 

Specific process. h Meee om 
2. STANDARD INPUT AND OUTPUT PATHS: the files/devices the 
process uses^fcr routine input and output, which- “typically 
corrspond to the keyboard and display. Eun 
S PROCESS PRICRITY which determines what Se i CFU 
time the process receives with respect to others. 


m 


peg 


Do9 


You can use the “PROCS” command to see all the proc ess 


es that 
exist under your user number and their status. It also sh6ws the 
internal process ID number assierd by OS-9 to identify it:^- You 
can abort any of your processes using the WEIL comma hd. M AL 
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THE OS-9 INPUT/OUTPUT SYSTEM 


08-9 has a unified input/output system which. means- data 


transfers to ALL I/0 devices are done exactly the same way. At 


first glance it may.seem that tne previous statement may  viclate 
Several laws of nature. After all, line printers and disk drives 
have vastly different | operational characteristics. These 
differences can be overcome by defining a Standardized LOGICAL 
STRUCTURE for all devices, and by making all I/O devices conform 
to this structure, using software routines to eliminate hardware- 


dependencies wherever possible. 


This logical input/output structure is based on somthing 
called an I/O PATH . It is defined as a description of a 
routing of data tetween a program (process) and a file or I/O 
device. The program end of the path is uniform all the time: 
but as data travels along the path it is routed and processed ty 
OS-9 to conform to the hardware requirements of the specific I/0. 


device. Data -transfered through a path is considered to be a 


Stream of binary bytes that have no specific type or context: 
what the data represents depends entirely on how it is used by 


programs. 


The main advantages of this method are: 


ls You can write programs that will operate correctly 
regardless of the particular 1/0 devices to be used when the 
program is executed. 


.2. Programs are highly portatle from one computer to 
another, even when the computers have different xinds of I/C. 
. devices. | 


Oe I/O can te redirected to alternate files or devices at 
run-time. | | : | | 


4. The same system calls used for physical input/output 
functions can te used for inter-process communications. 
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USING INPUT/OUTPUT PATHS 


When a path is created, the operating system is given a 
description of the routing of the path, which is called a 
pathlist . The pathlist is a list of one or more names 
separated by slash / characters.  Pathlists are used to specify 
where in the system a particular file or device can be found. 


Names have up to 29 (characters and may contain uppercase 
letters, lowercase letters, digits and underscore _ characters. 
The first character of a name must te a letter. 


ALL I/O DEVICES EAVE UNIQUE NAMES. The specific names used on 
a particular system are Somewhat arbitrary because they can be 
user defined, and depend or the type and number of I/O devices. 
For the purposes of the following examples, we will use these 
fairly customary names: 


TERM .|- Console terminal 
T1, T2, etc. | | - Other termirals 
| ie Printer 
De -~ Disk drive unit zero 


Li LL RN - Disk drive unit one 


All devices have two basic attributes: — 


Sharable or non-sharatle 
multifile or non-multifile 


A device is considered sharable if more than one process can 
access it at the sare time. Disks and terminals are usually 
sharable. Printers and tape systems are not usually sharable. 
OS-9 will not let a process establish an 1/0 path to a non- 
sharable device already in use by another process. | 


Multifile devices are mass storage devices such as disk 
systems that store data organized into individual entities called 
files . Each file has j name that is kept in a directory. ivery 


multifile device has a master directory (called the root 
directory ) that includes the names of the files and = sub- 
directories stored on the device. | 3 


These classifications are not mutually exclusive. For example 
a tape system may be | multifile but not sharable, a disk is 
sharable and multifile, a printer is neither sharable or 
multifile. | : M L 
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When OS-9 is asked to create an I/O path, it uses the names in 


the pathlist to search various directories to obtain | tne 


necessary routing information. These directories are organized 
as a tree-structured hierarchy. The highest-level directory is 


called the “device directory , which contains names and linkages 
to all the I/O devices on a given system. If any of the devices 


are of a multifile type they each have a root directory, which is | 
the next-highest level. | Here's what the tree of our example . 
system might look like: Z DD | 


DEVICE 
DIRECTORY 
' | 
! 
$m ÓÀ—— —À R—————Ó— e e ee L ae e ne wm —À — —À —— r À—  À— L n — À n —— ——  À  À À "€ 
! ! ! l ! 
{ ! ! ! ! 
P | TERM T1 
DO D1 
l t 
t ! 
Lee eean n ker e r dk * eee r ca ae oe ee onn wer ae men e + 
I l l 1 f 
l L ! ! ! 
data startup files mytext 
í | BASLIB 
! 
| ! 
L———— M R———————— R————— Ó—ÀÓ * 
! 41 ! ! 
f MEM ! | L 
| sort hano)  BUGLIST | 
GAMES EM | 
{ | 
L | 
de e —— R——————— + | 
if 1 (Q1 
L 1 of | 
adventure chess blackjack 


KA 
A 
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ae ae 


The, names in this example device directory are "TERM , "T1", "p", 
pO". .ando DL DG S root directory has two file names: data” 
and "startup á DIT S foot directory has three file names: 

P files, BASLIB', and mytext". BASLIB in this case happens to 
be a Special kind of- file called a directory which. contains the 
names of other files. in the system (they may also be 

directories). HE | | 


Let/s use the ccpy command to illustrate construction and use 
of pathlists. The LIST command has the following form: 


LIST pathlist | 


This command works by opening an input path, then reads data from 
the file and outruts it to the terminal. Suppose we want to 
display the contents of "file3” wich is located on device  "D1' 
the following command would be used: : 


OSG: LIST /DI1/fileS3 


The pathlist “/Di/files” is used to specify the input pathlist 
for the LIST command; 'D1' tells 0S-9 which device the file is 
on, and ‘files’ specifies the particular file. Notice that 
'/D1/file3" has.two names in it, this is because “Di” is a 
multifile device (and may have more than one file on it) so 
another name must te given to specify which particular file. 
elow is an example of a command that would duplicate "files 
located on device DL on a new file called E on device 
"DO": | 


0S9: COPY /D1/file3 /18/fileScony 


Here are some important rules that apply to usege of pathlists: 


E Pathlists cannot contain imbedded, Sr aces. or anything 
ther Mene legal names or delimiters (' Pa characters). 


2. Pati lists that begin with a slash start directory 
searching with the device directory, otherwise the search 
starts in the current working directory o~ this is 
described later on. | 


3. The nurber of names in a pathlist must exactly 
correspond to the numter of directories to te searched. 
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4. The same file name cannot appear more than once in any 
directory. Files with identical names can be used es lone 
as the names are in different directories. | uw eee 
5. The "." or '.." symbols can be used at the bégEnning of 
a pathlist to refer to the current working directorf and tne — 
parent directory of | the current working dtfectory, 
respectively. (These will be explained further oné-in the 
text). EA Me E oe ae 


kO 
L 
qa 
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HIERACHICAL DIRECTORIES 


We Nase already seen that there is a tree-structured ordering 


of at least two levels of directories: the system device 


directory is the highest level, and the multifile mass ‘storage 
device "root directories are the next level down. 


It is possible to create a virtually unlimited number of 
levels of subdirectories on a mass storage device using the 
"MAKDIR command. ‘There is also a service request of the same 


name that does the same thing. 


All multifile directories are actually lineis spec ial files. 
They can be opened” and read using the same service requests 
used for other files and devices, which can be very handy. 


To demonstrate how directories work, we ^11 asume that the 
disk in drive one ('"/D1'") aas been freshly formated so that there 
is only a root directory. We will now use the build command to 
create a tert file on Dl. The build command will print out “? 
as a prompt to indicate that it is waiting for a text line to be 


entered. It will place each line into the text file until an 


empty line vith only a S return is entered as shown below: 
0S9: BUILD /Di/filei | 
.? This is the first file that 
? we created. 
? 
0S9: 


We will get a list of the files on device Di’s root directory, 
which looks like this: © 


0S9: DIR /D1 


| Directory of /D1 15:45:29 
 filel1 


0S9: 


Notice that after the “DIR” command was entered, the computer 


displayed a line indicating what directory it was Snowing, end 


the time. On the next line it displayed the name of the only 


file in that directcr y which was files os 


(C) 1988,1981 MICROWARE SYSTEMS CORPORATION | | PAGE 16 


od 


| 08- -9 LEVEL ONE USER'S GI 
The 05-9 File System 


NS | The next thing that we will do is use the. “LIST” - command to 
display the text thet we put into the file: 


059: LIST /Di/filel 
This is the first file 
that we created. 


0S9: 


Now we will use the “BUILD” command again to create two more text D 
files and then use the DIR" command to display the files 
contained in direetory "ADL | 


OSS: BUILD /Di/myfile 
? This is the second file 
? that we created. 
? 5 
OSS: BUILD /Di1/newfile 
? This is another file. 
? 
OS9: DIR /D1 


f | Directory of /D1 15:52:29 
C ^ | filei | myfile newfile 


089: 


To make a new directory in this directory, we use the command: 


OSS: MAKDIR /Di/newdir 


The directory file "newdir" is now a file listed in D1’s root 
directory: | T 


0S9: DIR /D1 


Directory of /Di 16:04:31 | 
filel quyfile newfile newdir 
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So far, so good. Now lets create a new file and, put in the 
new directory, using the COPY command to duplicate filel': 


OSS: COPY /D1/filet /D1/newdir/filei clone 


Observe that the second pathlist now has. three nemes: Ha name of 
the root directory ("D1' ES the name of the next: lower directory 
(“newdir”), then the actual file name ('filei clone ). Here's 
what the directories look like now: 


DEVICE 
DIRECTORY 
! 
t 
Len en e an L n n n ——Ó——Ó ————————Ó—— ———À—— * 
t 1 1 i 
{ I f t [ 
t : j i F. 
: t l L i 
TERM P | 
Di RCOT | D2 ROOT 
DIRECTORY DIRECTORY 
; f f 
- ! ! 
v 2 | pee ene R-—————-—- — + erer eaae + 
al i i i | | 
É i E i i i 
filei myfile newfile fileA fileB 
newdir ; 
* 
! 
filelclone 


We can use the DIR command to look at the files on cur new 
directory: 


0S9: DIR /Di/newdir 


Directory of- /D1 /newáir 
filei clone 
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It is possible to use MAKDIR to create a new T c. in 
newdir which would add yet another she of directories. . to the 
System: 


059: MAKDIR /D1/newdir/another directory 


To copy a file te this directory we can do 


It should be apparent ty now that the lower the level of the 
file’s directory, the more names are required in it’s descriptive 
pathlist. | 


You may be thinking by now that a hierarchical file system is 
mostly good for improving your typing skills and otherwise 
complicating matters. This is really not so. The next section 
introduces powerful ways to change how directories are searched, 
which eliminates many long pathiists. This system is very 
important in a multiuser environment because it allows-each user 
to privately organize his cr her files as desired, without 
affecting other users. ! E 


Another advantage of the hierarchical directory system is that 
you can have files with identical names cn the same.device, 
providing that the names are in different directories. for 
example, ycu can have a set of test files to check cut a program 
using the same file names as the program's actual working. files, 
but there is no conflict because the files are in different 
directories. | : 


Here are some characteristics of directories: 


1. Directories have the same ownership and security 
attributes as reg gular tiles. See the File Security System 


2. Zach file is listed in exactly cne directory. 


Se Files can only te added to directories when they are 
created. MID : 


4. All files end directories from a device’s root directory 
downward must reside on the same device. 


A very important point to rememter atout directory files is that 
they mostly behave like “normal” files. This means progrems can 
easily read directories using the same Means used to access other 
files. NY — 
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USING AND CHANGING WORKING DIRECTORIES Eeo er ed 


Up to this point, we have used examples of pathlists that 
start searching at the system device directory (highest) level. 
In fact, we haVe forced this to occur because every pathlist used 
started with a / character. When a pathlist tegins with a / , 
OS-9 will ALWAYS start searching the device directory for the 
first name in the pathlist. j "PC fs 


Fach process has two working directories" associated with it. 


The simplest definition of a working directory is the. céireectory 


where pathlist searching begins when a leading '/" is omitted 


from a pathlist. Any directory that the process is permitted to 


access can be made & ana Re directory. 


The two working directories are referred to as the person) 


execution directory and the ‘current data directory. ~OS8e"9-will 
search the execution directory when it tries tc find things- “that 


it thinks are executable programs. This means that. shell:ecommend 
files must be in the current execution directory. > ZBe: data 
directory is used for all other file references. Qu. E UTE 


If your system is multiuser, the log-on program will initially 
set your working directories to those uA ms da in: E 


. password file. ; ; ; SR ee a Te 


Let's EC at an example of Eun) command OE 
the default working directory notation, and its equivalent 
expansion: | ot 


COPY filel filed 


This is equivalent to the following command if the current 
execution directory is “/D@/CMDS" and the current data directory 
is "/DO" : 


0S9: /DO/CMDS/COPY /D@/JONES/filel /DG/JONZS/file2 


Not only does the use of default directories save typing, tut 
files are accessed faster because fewer (usually ore) ab Reel OTI RE 
need be searched. | 

. The built in shell commands “CHD” and "cux" can be used to 
independently change the current working data and execution 
directories, respectively, These command nemes must 5e followed 
ty a pathlist thet descrites the new directory file... You must 
have permission to access the directory according tc normal file 
S rules. Dere are some examples: CN RES 0 US xn 


089: CHD /D1/new tate aur 
OSS: CEX E dir new. exec. dir 


f 1 | 
| l ; | 
L J | ; 


NEL T E E 
(C) 1980, 1931 HICROWARE SYSTEMS CORPOR ATION r ae PAGE 22 


OS-S LEVEL ONE USER'S GUIDE 
The 05-9 File System 


When using the CED or CEX commands, there is nothing special 
about the pathlists that you may use. If it begins with a slasn 
/  , OS-9 will tegin searching in the device directory for the 
new working directory, otherwise searching will begin with the 
current data directory. For example, the following sequence of 
commands set the working directory to the same file: NEN 
059: CHD /Di/mydir 
OS9: CED projectl 
0S9: CHD /Di/mydir/projecti (same effect as above) 

Because working directories are inherited from a process’ 
parent, the actual names may not te known, so special name 
substitutes are available. They are: | 

i always refers to the present directory 

- always refers to the directory that contains the 

name of the present directory (i.e., the next highest 
level directory) 
| These can te used in place of pathlists and/or names in 
Hu : pethlists. Here are some examples: | a : E 
OS9:,DIR . lists file names in the working data directory 
0S9: DIR .. lists names in the working data directory’s 
parent directory. 
0S9: DEL ../temp deletes the file “temp from the 
| working data directory’s parent directory. 
The substitute names refer to either the execution or date 
directories, depending on the context in which they are used. For 
example, if .. is used in a pathlist of a file which will te 
loaded and/or executed, it will represent the parent directory of 
the execution directory. Likewise, if . is used in a pathlist 
descriting a program’s input file, it will represent the current 
data directory. | | 
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THE FILE SECURITY SYSTEM 


As mentioned in the section describing “File Creation’, files 
are. given certain attributes when they are created. These 
attributes are: : = 


Ownership 

Date and Time Created 

Date and Time of Last Time File Was Modified 
Access Permissions 


The ownership is established by storing the user number of the 
creating process. The dates and times of creation and last 
modification are fairly, self- “explanatory. | The main security 
function is based on the access permissions . | 


There are six types of permissions that define how and by whom 
the file can be accessed. Each of the Six can be turned "off" or 
on" independently, BUT ONLY BY THE FILE’S OWNER. Here is a list 
of the access permissions: 


WRITE PERMIT TO OWNER: If on, the owner may write to the 
file or delete it. This permission can te used to protect 
important flles from accidental deletion or modification. 


READ PERMIT TC OWNER: If on, the owner is allowed. to read 
from the file. This can be used to prevent "binary files 
from being used as “Pest. files. 


EXECUTE PERMIT TO. OWNER: -If on, the owner can perform load, 
chain, and fork system calls using the file. This can be 
used to prevent non- -executable data Such as text to be 
accidentially used as program data, which has very nasty 
consequences. i | 2 


The following  "putlic permissions work the same way as the 
owner permissions atove but are aprlied to precesses having 
DIFFERENT user numbers than mm Pile: S owner. | | 

WRITE PERMIT TO PUBLIC 

V READ PERMIT TO PUBLIC. 
EXECUTE PERMIT TO PUBLIC 
For exampie, if.a particular file had all permissions on 
except write permit to public and ‘read permit to public”, the: 


owner would have unrestricted access to the file, tut other users. 
could execute it, but nct read, copy, delete, or alter it. 


The "DIR" command may be used to see the security permissions of 
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the files in any particular directory when, the ^"E' option is 
used. It is important to note the the "ER" is an option for the 
DIR command and not a pathlist. Other commands may have options 

which are usually a single character which has special meaning 
for that command. Please see the command descriptions to find 
out what options may be used.. Belew is an example cf the DIR 
command, being used with the E option. wnich means Show the 
"Entire directory: T 


0S9: DIR E 
Directory of . 10:22:44 


Owner Last Modified Attritutes Sector Bytecount Name 


Jue umm. ED APUD GRE. amp mirar MAD maier ER QUÀ err XM r XM ate ie cu —— — ppp r ai) enw UD GA ID eee om «mm ene amo rer AMD T en m ers Ba oM Om HUP Re T npe ia mee 


ð 81/04/29 0282. .—-—9- NT 47 — 42 filel 

Ø 81/04/29 0215 .------—: WI £3 43 myfile 
ð 81/04/29 222  ------ wr 51 22 newfile 
9 81/04/29 0233  d-ewrewr 6D BO mydir 


This command displays the "cwner" cf each file, in this case, all 
files happen to belong to user number zero. The ‘Attritutes 
indicate what security permissions have been allowed for each 
file. Sector is the Starting sector number of the file 


. descrirtor sector. For filel , only private read and privete 


write permissions have been allowed. The permissions allowed ror: 
directory -mydir are as follows: , 


d 


Directory file 


i 


Public| execute, putlic write, public read, 
private exectue, private write, private read 
(in order) | 


ewrewr 


The "ATTR'" command may te used to change a files security 
permissions. For example: 


OS9: ATTR myfile pw pr 
This command enables public write and public. read permissions for 


the file "myfile'. Note: pw and pr are options of the ATT 
command and not patnlists. ! 
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MASS STORAGE FILES 


Mass storage files are kept on multifile devices such es disks 
or some kinds of tare systems. The same file format is used 


regardless of the type or size of disx system used. 


A file is an independant ordered sequence of data bytes. 0S-S9 
is not concerned with what the bytes represent: they are treated 
as pure data. The data could be a machine language program, 
characters of text, or anything you want. Data is written to and 
read from files exactly as given. The file car te any size from 
zero up to the maxirum capacity of the storage device. The 
theoretical limit is cver four billion bytes. Files can be 
expanded or shortened as desired. 


Creating New Files 
An OS-9 service request called “create” is used to make new 
files. A pathlist is given with this request which specifies the 


directory in which the file name is to be placed, for example: 


/DO/my_new_file 


The file is also given, some attributes which are described 


further on. The 68-9 "create service request E a unique 


path number that is used to refer to the flie as PORE: it is 


opens 


Accessing Existing Files 


The OS-9 service request called “open” can be used to 


-establish a path to an existing file or device according to a 


Specified pathlist. It alsc returns a unique path number used in 
a references to the d a ye | 


Reading and Writing Files 


When a file is created or opened a “file pointer’ is 
established for it. Bytes within the file are addressed like 
memory, and the file pointer holds the "address" of the next byte 
in the file to be written to or read from. The 05-9 “read” and 

‘write’ service requests  elways update the pointer as date 
transfers are performed. | | | xw 


Files can be read from and written to SeQguentiaily and/or 


 Tandomky in any combination of ways. AS mentioned above, the 


file pointer addresses the next data to te transferred, and the. 
pointer is automatically updated in the process or readirg or 
writing. Therefore, sucessive reads or writes will perform 
Sequential data transfers. LE 
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A service request called "seek" can te used tc reposition the 
file pointer to any byte address in the file. This is used when 
random access of the data is desired. S | 


To expand a file, you can simply write m the previcus ead 
of the file. | Reading up to the last byte of a file will cause 
the final read request to return an end-of-file status. 


Compatibility With Non-Multifile Devices 


The same 0S-9.service requests that operate on mass storage 
files work on other kinds of, devices as well. As mentioned 
above, the open and ‘create -© requests are also used to 
establish paths tc all other devices, the only difference teing 
the routing given in the patnlist. | 


À natural question at this point is "how can you ‘create’ a 
printer, or “seek” a terminal? . Obviously, the enswer is that 
you can’t, but these undefined operations can be SIMULATED or 
IGNORED: and things usually work out OX. For exemple, when tne 
printer driver routine receives 4 create" request it does an 


equivalent operation: "open" . When you ask a terminal driver te 


seek" it simply ignores the request ard does not return an 
error. | AME 


TN THE VAST MAJORITY OF CASES, PROGRAMS INTENDED FOR USE 
WITH MASS STORAGE FILES WILL WORK CORRECT WITH NON- 
MULTIFILE DEVICES. THEREFORE, DEVICES AND FILES CAN BE USEI 
INTERCHANGABLY. | 


This unusual consistancy of the OS-9 unified I/O system allows 
you to design programs that are highly portabie and mostly 
hardware irderendent. 
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THE OS-9 SEELL 


The shell is a command interpreter that reads cue lines ana 
processes them as requests to run other programs. Tae processing 
can also involve interpretirg optional parameters that control or 
modify execution of programs. When the shell is first entered it 


prints: 


The  "OS9:" is a prompt which indicates that the shell is 


expecting input. A command line cen be typed which has the 
elementary form: 


<program name> <perameters> 


The <program name> is that of the program to te executed. The 


program can te a module already in memory, or a complete Fathlist 
describing a file that contains the desired program. Shell 
passes the <parameters> to the program after filtering out" some 
of its own "built in parameters. What parameters are spec ified 
depend upon the program to be executed. Eere’s an ex ample of a 


. simple command line: 


QS9: copy filei filez 


In. this | command line, tke "(program name» |. is, cor 
<parameters> are the two file names fileli and file 
file names are used tecause thi is what the "copy program 
expects. Some programs exrect zàrameters which are not file 
rames; cthers expect (or optionally expect) rarameters other than 
file names; some programs don’t require any parameters at all. 

To. find out what parameters a program expects, see the command 


description section of this manual. 


Programs are executed by shell using the "fork" system call, 
$0 they become separate, child processes of the shell. In the 
simple example above, the shell suspends itself until the “cory” 
rrocess performs its function and terminates. Tae Snell is then 
reactivated and prints a promrct for the next command iine. The 
shell execution loop repeats until an end-of-flle is enccuntered 
on its input file/device. 
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In additicn to tne basic input/execute function, tne shell has 
several other important optional facilities that are used to 
modify program execution, run multiple programs simultaneously 
(“concurrent execution ), and execute procedure files. Eeca. of. 
these topics is explained in the following sections. There is a 
virtually unlimited number of ways these capabilities can be 
used, and it is impossible to give more than a representative set 
of examples in this guide. You are therefore encouraged to study 
the basic rules, use your imagination, and "explore the 
possibilities on your own. 


EXECUTION MODIFIERS 


Alternate Memory Size 


When command R are invoked ty the shell, they are 
allocated the minimum amount of working RAM memory specified in 
the program’s module header. Sometimes it is desirable tc 
increase this memory size; this may be done by using the shells 
alternate memory size modifier. For example, the copy programs. 

module neader indicates a requirement of 512 bytes of memory. °° To 
Speed up the copy, we can assign it more memory. Memory can be 
assigned in 256-byte pages using tne.modifier #n where n is the 
number of pages, or in 1024 byte increments using the modifier 
#nK . The two examples below tehave identically: 


OSS: copy #8 filel filez 
039: copy #2K filel file2 , 


In general, modifiers can be used tefcre OR after the program's 
parameter list, if eny. 


NOTE: Before the shell passes parameters?» to a progrem, it 
filters out its own built in options. For tne examples above, 
the COPY program will only receive "filet file2 as. its 
<parameters>. | 
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The second kind | of modifier is used to redirect the program's 
"standard I/O paths" to alternate files or devices. . Correctly- 
written OS-9 programs use these paths for routine I/C. Because 
the programs do not use Specific file or device names, it is 
fairly simple to "redirect! the I/O to any file or device without 
altering the program itself. | 
Programs which normally receive input frcm a terminal or send 
output to e terminal use one or more of the standard I/O paths as 
defined below: | l : 


STANDARD INPUT: p path nermally passes data from the 
terminal's keyboard to the program. : | 


STANDARD OUTPUT PATH: This vath is normally used to output 
data from the program to the terminal’s display. 


STANDARD ERROR OUTFUT PATH: This path is used to output 
routine status messages such as prompts and errors to the 
terminal’s display (defaults to the same device as. the 
standard output path). NOTE: The name error output" is 
sometimes misleading since many other kinds of messages 
besides. errors ate Sent On this path. | S L a ae 


Recall that when prócesses are created by the “fork” system 
call, they inherit the parent process Standard I/O paths. 
Therefore, when the shell creates new processes, they usually 


inherit its standard I/C paths. When you log-on the shell’s 


Standard input is the terminal keyboard; the standard output and 
error Output is the terminal’s display. When e redirection 
modifier is used on a shell command line, the shell will cpen the 
corresronding paths and pass them to the new process as its 
standard I/O paths. There are three redirection modifiers as 
given belcw: : 


€ | Redirect the standard input path 
S Redirect the standard output path 


>> Redirect the standard error output rath 
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When redirection modifiers are used on a command line, they 
must be immediately followed by a pathlist descriting the file or 
device the I/O is to be redirected to or from. For example, the 


Standard output of "list" can be redirected to write to the 


System printer instead of the terminal: 


0S9: LIST correspondence »/o 


Note that in this example, shell filters the redirection 
modifiers (and their pathlists) out of the <parameters> which are 
passed to LIST. The only thing- that. LIST. will. see in its 
rarameter is the file name correspondence . | 


Files | referenced by I/O redirection modifiers are 
automatically opened or created, and closed as appropriate: 
Here/s another example, the out ut of the DIR command is 


redirected to the file '/Dpi/dirlist 


0S9: DIR »/D1/dirlist 


If the LIST command is used on the file "/Di/dirlist", output 
from the DIR command will te displayed as shown below: | 


0S9: LIST /Di/airlist 


Directory of . | 12:15:00 | 
myfile dirlist o filel 


Redirection modifiers can be used before or after tne 
programs "S Parameters, but each modifier can only be used once. 
per program. — | | | 
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COMMAND SEPARATORS 


E Single shell input line can request execution of more than 
cne program. These programs may be executed sequentially or 
concurrently. Sequential | execution means that one program must 
complete its function and terminate before the next program is 
allowed to begin execution. Concurrent execution means that 
several programs | are allowed to begin execution and rur 
simultaneously. | 


Sequential Execution 


Programs are executed sequentially when each is ertered on a 
separate line. To save time and typing, more than one program 
can be specified on a single shell command line by spearating 
each <program name> <parameters> from the next one with a j; 
character. For exarple: 


0S9: COPY myfile /D1/newfile ; DIR >/p 


"This command line will execute the COPY command, and then after 


the copy is COMPLE Ve qub DIR command will be executed. 


Bere are some more examples: 


+ 


OSS: copy oldfile newfile; del olafile; list newfile 
0S9: dir >/di/myfile ; list temp >/p; del temp 


Concurrent Execution 


The second kind of separator is the "&' which implies 
concurrent execution, meaning that the program is run but the 
shell dees not wait for it to complete before starting the next 
cne This is the way that "detatched'" processes may be created 
and is the essential mechanism that performs multiprogramming on 
your command. The number of programs that can run simultaneously 
is not fixed: it derends upon the amount of free memory in the 
system versus the memory requirements of the specific programs. 
Fere is an example: 


059: DIR >/P& 
. KET 


This command line will cause shell to start the DIR command 
executing, print the process ID number (6207) and then shell will 
immediately print the OSS: promt and welt for another command 
to be entered. Meanwile the BIR command will be busy sending a 
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directory ‘listing to the printer. You can display a “status 
summary of all processes you have created by using the PROCS. 
command. Below is enotner example: | m. 

089: DIR 5/P& LIST file1& COPY filel file2 ; DEL temp 


Because they were ;Psllowed ty '& seperators, the DIR, LIST, and 


COPY programs will run concurrently, but the DEL program will 
not run until the last COPY program has terminated. 


Pipelines 
| 
The third kind of Separator is the “! character which is used 
to contruct rirelines . Pipelines consist of two or more 
programs whose standard 1ncut and/or output paths connect to each 
other rather than to files or I/O devices. These special kinds 


of paths-are called, pipes and are the primary means by which 
data is transfered from process to process. Pipes behave in 


exactly the same way as conventional files except I/0 transfers 


between processes are automatically synchronized to the processes 
rather than to bue devices. Pige seperators must always be 
followeà ty a program name. Eere is an example pipeline: 


[ 
Ç 


059: update «master, file ! sort ! write rerort >/d 


In the example a ae, the program "update" has its input 
iiM a es from a path called "master. file". „Its standard output 
becomes the standard input for the program “sort”. Its output, 
in turn, becomes | the standard input for the program 
write report', which has its standard output redirected to tne 


printer. | 


All the programs execute ccncurrently, and the I/O is 
automatically synchronized So the output of one program never 
gets ahead of the input request of the next program in the 
civeline. This implies that data cannct flow through a pipeline 
any faster than the slowest program can trocess it. Some of the 
mest useful applications cf ripelires are jobs like character set 
conversion, print ES formatiirg, date compressions 
/decompression, data monitoring, etc. These types of in-line 
programs are oft en called filters ; P. 


Note that your system may not have e rire file manager: it is 
standard with OS-9 Level Two systems, tut optional with OS-S 
Level Cne sy stems. | : vd. ra 
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Command Grouping 


Sections of shell input- Ires can be enclosed in rarentneses 
which permits modifiers and separators to be applied to an entire 
set of programs. The shell processes them by calling itself 
recursively (as a new process) to execute the enclosed program 
list. For example: | | 


089: (dir /d2; dir /d1) >/p& 
OSS: (list f1; list f2)& dump obj >/p& 


SHELL PSEUDO COMMANTS 


When processing input lines, the -shell locks for several 
Special names of pseudo-commands" : commands that are tuilt-in tc 
the shell and are executed without creating a new process. They 
generally affect how the shell operates. They can be used at the 
beginning of a line, or followinz any rrogram separator ( 5; , 

E 540p 1 a Two or more adjacent pseudo-commands can te 
Sezarated by Spaces or commas. | 


| | 
The pseudo-comrands and their functions are: 


chd <pathlist> change the working data directory to tne 
directory specified by tne pethlist. 


chx <pathlist> change the execution directcry to the 
, | directory specified by tne pathlist 


ex nare. directly execute the module named. his 
| transforms the shell process so it ceases 

fc exist and a new one bezirs execution in 
its place. 

W wait fcr any process tc terminate. 

* text | comment: "text" is not processed. 

kill «proc ID> sends abort signal to process 

setpr <prec ID? <priority> changes process” priority 


xv | causes shell to abort on any error | 
-X | = causes shell not to abort on error (default) 


e 


MN turns shell prompt and messages on (default) 
"PN . inhibits shell prompt and messages | 
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t pot makes shell copy all input lines to output — 
-t | does not copy inrut lines to output (default) 


The change directory. commands switch the Shell/s | working 
directory and, „by inheritance, any sutsequently created child 
process. The ex command is used where the shell is needed tc 
initiate execution of a program without the overhead of 4 
suspended "shell process. The name used is processed according 
to standard shell operation, and modifiers can be used. 


EXECUTION CF SHELL PROCEDURE i FILES 


The shell is e reentrant program that can te simultaneously 
executed by more than one process at a time. As is the cese with 
most other OS-9 programs, it uses standard I/O paths for routine 
input and output. Specifically, its requests ccmmand lines from 
the standard input peth and writes its prompts end cther data to 
the standard error path. | | | 


The shell can start up another “incarnation of shell by 
executing the SEELL command. If tne standard input, path is 


redirected to a mass storage file, the new incarnation of shell 
can accept and execute ccmmand lines from the file instead of a 


A keyboard. The text file to be processed is called a 

rocedure file’. It contains one or more command lines that are. 
identical tc command lines that are manually entered from the 
keyboard. This - technique is sometimes called Joe strear 
processing . 


If the <progranm name> specified cn a shell command line can not 
te fourd in memory cr in the execution directory, shell will 
search the data directory for a file with the desired name. If 
2 is found, shell will automatically execute it as a procedure 
file.. | 


Fxecution of procedure files havea number of valuable 
applications. It can eliminate manual entry cf commonly-used 
sequences of commands. It can allow the computer to execute a 
lengthy series of programs in the background while the computer 
is unatten ded or while the user is running other programs in the 
foreground”. s 


In addition to redirecting the shell/s standard input to a 
procedure file, the standard output and standard error output car 
te redirected to another file which can record output for later 
review or printing. This. can also eliminate the. sometimes- 
annoying output of shell messages to your terminal at random 
times. | s ar ) 
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Here are two simrle ways to use the shell to create another 
ell: | UR 


Ks shell Crrocfile 


0S9: procfile 


Both do exactly the same thing: execute the commands of he. file 
"procfile’. To run the procedure file in a "background" mode you - 
simply add the ampersand operator: ME k 


. 0898: procfile& 


035-8 does not have any constraints on the number of job streams 


that can be simultanecusly executed as long as there is memory 
available. Also, the procedure files can themselves cause 
sequential or concurrent execution of additional procedure files. 
Here’s. a more complex example of initiating two processing 
streams with redirection of each shell's standard output to 
files: 


OSS: proci T >>stati& proce T »22statz& 


Note that the rseudo-command "T (copy input lines to error 
utput) was used atcve. They make the output file contain a 
record of all lines executed, but without useless "OSS" prompts 
intermixed. The "x  pseudo-command can be used if you want tne 


"processing to step if an error occurs. Note that the pseudo- 


commends only affect the shell that executes them, and not any 
others that may exist. 


EXECUTION OF NON- MACEINE-LANGUAGE PROGRAMS 

| | | Jv 
Fefore shell executes a program, it checks the program module’s 
language type. If its tyne is not 6509 machine language, shell 
will call the appropriate run-time system for that module. For 
example, if you wanted to run a BASICZ29 I-code module called 
adventure , ycu could type the command given below: 


OSS: BASICS adventure 


Or you could accomplish the same thing by typing the following: 


OSS: adventure 


© (C) 19890,1981 MICROWARE SYSTEMS CORPORATION —— |. PAGE 34 


P dp 


CS-9 LEVEL ONE. USER'S GUIDE 
The 05-9 Shell 


Using the Shell For Timesharing 
3 l i ; & 


OS-S systems used for timesharing usually have a procedure 
file that brings the system up by means of a one simple command. 
A procedure file is created that creates one process for each 
terminal. The procedure file first starts the system clock, then 
initiates concurrent execution of a number of processes that have 
their I/O redirected to each timesharing terminal. 


Usually one TSMON command program is started up concurrently for 
each terminal in the system. This is a special program. which 
monitors a terminal for activity. wnen a carriage return 
character is typed on any of t£ese terminals, the TSMON command 


initiates the LOGIN command program. If a user does not enter a 


correct password or user number in three tries, the LOGIN command 
will be aborted. Here's a sample procedure file for a S-terminal 
timesharing system having terminals names T1 , T2 , and TS .. 


* system startup rrocedure file 

setime 

tsmon t1& 

tsmon t2& 

tsmon t3& 

echo ** timesharing system now on-line ** 
ex tsmon 


NOTE: This LOGIN procedure will not work untill a password file 


called "/DO/SYS/PASSWORD" has been created. For more 
information, please see the LOGIN command description. | 


WARNING: | Due to the fact that ACIAS do not have a hardware 


reset, if the system is reset while a path to an ACIA is open, 
its interructs may be left enabled. If data is received by such 
an ACIA, it will generate an interrupt that the system can't find 
if the device has not yet been attached to the system. The 


© result of OS-9 not finding an interrupt is usually a syster 


crash.} This problem may be cured ty starting up a TSMON on 
each terminal as soon as possitle after reset. This will attach 
the devices to the system so taat their interrupts may be found. 


(C) 19890,1981 MICROWARE SYSTEMS CORPORATION —.— > OPAGE 55 


SYSTEM COMMAND DESCRIPTIONS 


This section of the User’s Guide contains descriptions for 
each of the standard command programs. These programs are 
usually called using the shell, but can be called from many other. 
OS-9 family programs such as BASICOS, interactive Debugger, Macro 
Text Editor, etc. Unless otherwise noted, these programs are 
designed to run as individual processes. | 


Formal Syntax Notation 


Each command description includes a syntax definition which 
describes how the command sentence car be constructed. These are 
symbolic descriptions that use the following notation: 


[ ] - Brackets indicate that the enclosed item(s) are 
optional. | 


() | - Braces indicate that the enclosed item(s) can te c 
opticnallY repeated. 


<path> = Represents any legal petalist. 

Xdevname» = Rerresents any legal device name. 
<modname> = Represents any eee memcry module nane 
<procID> = Represents a process number. 

<opts> = One or more cpticns defined in the command 
| description. 

<arglist> = a list of arguments (perameters) . 


<text> = a character string termminated by end-of-line. 


li 


NOTE: The syntax of the commanás given does not include the 
shell's built in options such as alternate memory size, I/C 
redirection, etc. This. is because tne shell will filter its 
options out of the command line before it is passed. to the 


program being called. 
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Charge file security attributes. Pon ATTR 


Syntax: ATTE <path> [ { <permission abbreviations? L ] 


This command is used to examine or change tne security 
permissions of a file. To enter the command, type ATT 
followed by the pathlist for the file who S security. permissions 
are to be changed, followed by a list of permissions which are tc 
be turned on or off. A permission is turned on by giving its 
abbreviation, or turned cff ty preceding its abtreviation with a 
minus sign. Permissicns not named are not afffected. If you do 
not specify any permissions, the current file attritutes will be 
printed. You can nct change the attributes of a file which you 
do not own (except for user zero, who can dd the attributes 
of any file in the system). 


The file permission abtreviations are: 


d - Directory file 

S = Sharable file 

r = Read permit to owner 

w = Write permit to owner 

e = Execute permit to owner 
pr = Read permit to public 
pw = Write permit to putlic 
pe = Execute permit to public 


The ATTR command may be used to change e directory file to a non- 
oe file if all entries have teen deleted from it. Since 
the DEL command will cnly delete non- -directory files, this is the 
ouis. way a directory may be deleted. You cannot change a nor- 
directory file to a directory file with this command (see 
MAKDIR). 


Examples: 
attr my file -pr -pW 
attr myfile rw e pr rw pe 
OS9: DIR E 


Directory of . 15:02:02 
Owner Last Modified Attributes Sector 5ytecourt Name 


T dem alb enger oae, a «map t HMM "UP srar UEM MADE HAT DUMP GUT e tt Mew «unen bim pP QM eror ree mr ar AEA aug vwu em mach aum eaz es dir ren apre rrr mn r r. ra n eer mfz ebo. mner 


O 81/04/15 1257. aB 4C 2 myfile 


0S9:ATTR myfile r w pr -e 
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Make a tackup copy of medie | BACXUP. 
Syntax: BACKUP [e] [s] [-v] [<devnam> [<devname>]] 


This command is used to physically copy all data from one device 
to another. A physical copy is performed sector by sector 
without regard to file structures. In almost all cases the 
devices specified must be of the same type (size, density, etc.) 


If both device ngre are omitted the names “/DZ"” and "/di" ar 
assumed. If the second device name is omitted, a single uni 
backup will be performed on tae drive specified. 


e 
P 
v 


the options are: 


E = Exit if any read error occurs. 
S = Print single drive prompt messege. 
-V = Do not verify. 

#nK = 


more memory makes backup run faster 
Examples: 


backup /D@ /D1 


backup -V 


OSO:tackup #22K /DE /D1 

Ready to BACKUP from /D£ to /D1 7: Y. 
MYDISX is being scratched E 

QR 75 Y 
Number of sectors copied: $412 
Verify pass 

Number of sectors verified: $9420 
OS9: | 


C2 
bu 
^ 
tO 
(D 
c 
E» 
LD 
0D 
BA 
ure 
H 
C3 
pul 
C7 
= 
nh 
n 
t 
n 
Ka 
Ui 
rà 
tə} 
7 
C 
Ca 
Ce 
Li) 
CO 
© 
ni 
fe» 
2 
m 
© 
a. 
ta 
i 
Gi 
bi 
[A 
(L 


CS—9 LEVEL ONE USF 


TR'S GUILE 
System Command Descriptions 
BACKUP (continued) 
Below is an example of a single drive backup. BACKUP will read a- 


portion of the scurce disk into memory, you remove the source 
disk and place the destination disk inte tne drive, BACKUP writes 
on the destination disk, you remove the destination disk and 
place the source disk into the drive. This continues until the 
entire disk has been copied. Giving BACKUP as much memory as 
possible will cause fewer disx exchanges to.te required. 


059: oe #12K Jro | 
Ready to BACKUP from /DC€ to /D€ 2: Y 

Ready DESTINATION, hit a key: 
MYDISK is being. scratched 

OL QUI 

Ready SOURCE, hit a zey: 

Ready DESTINATION, hit a key: 

Ready SOURCZ, hit a key: 

Ready DESTINATION, hit a key: 


(several repetitions) 


Ready DESTINATION, hit a key: 
Number of sectors oe SADC 
Verify pass 

Number of sectors verified: $4D£. 
0S9 
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Build a text file. pu | | 3UizD: 
Syntax: BUILD <path> 


This command is used to build short text files by copying the 
standard input path into the file specified by <path>. To use 
this command, type BUILD followed by the pathlist for the text 
file which you want to create. Tae computer will respond by: 
printing 7 as a prompt. This means that it is waiting for you 
to enter a line of text. After you enter a text line, the 
computer will place it into the file, print ? as a prompt anc 
wait for you to enter another. This continues until you type an- 
empty line (a carriage return ona | 


Example: 


build small, file | | 
tuild /p (copies keyboard to printer) 


The Pte input path may also be redirected to a file. elow 
is an example 


build €mytext /T2 (copies file “mytext to terminal T2): 
OS9:tuild newfile 
? Hello Computer. 
? The powers of the 05-9- 
? operating system are truely 
? fantastic. » P" 
'? Enter an empty line to terminate build 
? | 


OSS:LIST newfile 

Hello Computer 

The powers of the OS-9 

Operating system are Vue ly 

fantastic. : 
Enter ar empty line to terminate "build" 


if 
Lam) 
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Change working data directory | bo DM 0 
Change working execution directory CEX... 


Syntax: chd <eathlist> 
| chx <pathlist> 


These are shell "built in" commands used to change OS-S's working 
data directory or working execution directory. Many commands in 
OS-S work with user data such as text files, BASICZƏ programs, 
etc. These commands assume that a file is loceted in the working 
data directory. Other OS-9 commands will assume that a file is 
in the DI S alrectory. For a full description 
please see SHE ETC 


NOTE: The pathlist given must specify a directory file. 


Examples: 


chad /di/master_acccunts 

ChX .. | | 
chx tinary files/test programs 
chx /T@ $; chd /Dl- 


OSS:dir 
Directory of . 14:40:24 ROS 
CMDS USER EDIT |. Ee 
DATE : EXAMPL p 
OS9:chd test 
OSSidir ) 
Directory of . 14:41:13 
myfile 
0S9:chd ../cmds 
OS9:dir l 
S Directory of . . 14:46:40 > | 
BUILD | FORMAT COPY LIST 


pin) |. DEL BACKUP 
089: | 
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Install toot file on device. | — - COBELER 


Syntax: COBBLER / <device name> 


This command is used to install a toot file on a device. The 


toot file will consist of the same modules which were loaded into 


memory when OS-9 was initially started. 


NOTE: The boot file must fit into one contiguous block on the 


rass-storage device. Fer this reascn COBBLER is normally used or 
a freshly formatted. disk. If COBBLER is used on a disk end there 
is not a contiguous block of storage large enough to hold the 
toot file, the old boot file may have been destroyed and O5-S 
will not te able to toot from that disk until it is reformatted. 


Example: 


OSS: ccbbdler /Di 
oss: 


(C) 19829,1981 MICROWARZ SYSTEMS CORPORATION © | PAGE «2 


05 9 LEVE ar ONE USER'S GUILE 
System Command De S BS 
Copy data frem one path to another. | : a LA G6EY ese 


Syntax: | COPY «path? <path> 


This command copies data from the first file or device..-specified 
te the second. The first file cr device must already exist, tne 
second file is created if the device is multifile. Data may be 

of any type and is NOT modified in any way as it is S rM 
Data is transfered using large block reads until end-of=file 
occurs on th inrut path. Secause tlock transfers are used, 
normal output processing of data does not occur on character- 
oriented devices such as terminals, printers, etc. .ingrefore,. 
the LIST command is preferred over COPY when a file consisting of 
text is to be displayed on a terminal. A 


Using the shell'/s alternate memory size modifier to give copy a 
large DETOTE Space can ore en increase its speed. 


Examples: 
i copy #15K filel file2 | ^ (copies filei to filez2) 
m copy /D1/joe/news /& : | 
Bash copy /TERM 78H (copies console to printer) 


OS9:dir 


Directory of . 15:61:32 
myfile 


OSS:copy myfile newfile 
59:21 T ) 
Directory of « 15:02:27 
myfiie newfile 
OS9:1l1ist newfile 
This is some example text copied 


from myfile" " 


CSG: 


Pa 


tee AM pre vo toa 
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" 
PEE, 
ystcem Command Descriptions 


ias 


Display system dete amd tine. DATE 
Syntax: DATE [t] 


This ccmmand is used to print the current system date. If the 
option- is given, the current time is also displayed. | 


Example: - 
date t 


date t >/p | (Output is redirected to printer) 


OSS:setime | 
YY/MM/DD BH:MM:55 
TIME ? 81/04/15 14:19:20 


L fo tput LIR porp ” Ttov t wo o L 
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Delete a file. 


t3 
fr 


Syntax: DEL <path> {í «path? } 


This command is used tc delete the file(s) specified by the 
pathlist(s). The files specified must have write permission. 
Directory files cannot be deleted unless their tyre is changed to 
non-directory: see the ATTR command BESRINPDASUS ; 


» 
e 


ixamples 


del test program old test progrem 


del /Di/number five 


OSS$:dir /D1 


Directcry cf /T1 14:29:46 
myfile | newfile 


I "m | 
039:del /Di/newfile 
OSS:dir /Ti 


Directory Of /D1 14:32:37 
myfile 
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Display the names of files contained in a directory. "gor OEP 


Syntax: DIR [e] [<path>] 


Displays the nares of files listed in the directory file 
specified by <path>, or the current working data directory if the 
pathlist is omitted. 


If the "e" option is included, each file’s entire description is 
displayed: size, address, Owner, permissions, dete and time of 
last modification. l 


The following forms of the dir command are epecially useful: 


Examples? 


dir (display working data directory) 


dir. | | (display working data directory) 
dir (display parent of working data directory) 
dir newstuff (display newstuff directory) 


dir e test programs 


| OS9:dir 
Directory of . 15:45:23 | 
CMDS USER EDIT TEST 


DATE example 


OSS:dir cmds 


Directory of cmds 15:45:42 


BUILD FORMAT | COPY LIST 
DIR DEL BACKUP 
059: 
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Dump (display) contents of file in hex format. DUMP 


Syntax: DUMP [<path)] 


This command. produces a formatted display of the eactual-data.or 
the mass storage file srecified. The data is displayed: .in: -both 
hexadecimal and ASCII character format. Data tytes that have 
non-displayatle values are representec by periods in. the 
character area. If a pathlist is omitted, dump uses-standard 
input. | Rp e 


The addresses displayed on the dump are relative to the beginning 


of the file. Because memory modules are position-independent and 
stored on files exactly as they exist in memory, the addresses 


shown on the dump ccrrespond to the relative load addresses of 


memory-module files. 


Examples: 


DUMP (display xeytoard input in hex) 
DUMP myfile »5/P (dump myfile tc printer). | 
DUMP shortfile | -— ——— 


OS9:save /dl/examrle term 
OS9:dump /di/examrle 


Addr $4:23.45 67 89 AB CD EF $£246804€6z 


@@@@ 87CD 228 C224 F181 2820 2ECG 3123 FFEG  .M.8.*q.(...1.." 
CLIC (0418 20220 0120 Gili 0201 18€8 180D 1:246  ............ 


Qo20 2117 2211 0597 1500 002A 5445 52CL2 5848 elec. ORMERMSC 
9030 C641 4349 CIBE IZ9E  FACIA.R. 
OSS: 
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System. Command Lescriptions 


oy U Echo input to outrut path. | o5 UREHOC 
Syntax: ECHO <text> 
This command echoes its argument to the standard output path. It 
is typically used tc generate messages from shell procedure files 
or to send an initialization character sequence tc a terminal. 
Examples: A 
echo >/T2 Hello John, how’s it going & |. (echo to T2) 
echo >/term ** warning ** disk about to be scratched! 
echo >/p Listing of Transaction File; list trans >/p 
OSS: ECHO hello world 
hello world 
" ee ; | 


| 
| 
| 
" i * 
| 
| 
| 


i 
| 
| 
H 
| 
| 
i 
| 


i 
| 
| 


j f 
I 
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System Command Lescriptions. 


£ 


Execute a program. | 7 de E EX 


Syntax: EX «module name> [<modifiers>] [<parameters>] 


This a Shell built-in command that changes the process from 
execution of the shell to execution of another program. It 

permits a transition from the shell to another program without 
creating another process. This command is often used when the 
shell is called from another program to execute a single, 
specific program, after which the shell is not needed. For 
instance, applications which only use  EASICZO need not waste 
memory space on SHELL. | | : | o 


The "ex" command should always be the last command on a shell 
input line. See the SHELL description for more information. =: 
bxamples: 

ex BASICS 


dir /d1; ex tsmon 


Initialize media. ^ e | TL FORMAT 


Syntax: FORMAT <devname> [<option list>] 


This command | is used to physically initialize, verify, and 
establish an initial file structure on floppy disk media. All 
floppy disks must be formatted befcre ee can be used on an O$-9. 
system.. 


This command can format many types of disks. A description of 
the disk is automatically read from the device descriptor module. 
The <option list> may be used to override these default values if 
necessary. Format will ask for any required options not given in 
the command line. The options are: 


single density (default) 

double density 

single sided (default) 

double sided 

inhibit ready prompt | 

number’ = number of tracks (in decimal) | 
;number: = number of sector interleave value (decimal) 
name - disk name (32 character maximum) 


«5A M KA c2 0 
"ow wo n di 


The formatting process works as follows: 


i. The physical format is written on the disk. 


2e Fach Sector 5. read „back and verified. If 4 sector 
fails the test it is "locked out cf the initial free sSpacė 
on the disk. As the verification is performed, track numbers 
are displayed on the standard cutput device. 


3. The iik allocation map, root directory, identificaticr 
block. : l 


Examples of dd to use FORMAT are given on the next page. 


€ 4 < x d 
C$-9 LEVEL CNE USER'S GUIDE 
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ams, 
het 
C3 
na 
<_< 
t> 


AT (continued) . 


r 


forrat /D1 2 D “database '77 
format /D1 S 1 | 


OSS: format /21 
FORMAT 1.1. 
TABLE OF FORMAT VARIABLES 


Recording Format: MEM 


Track density in TPI: £5 

Numter of Cylinders: 77 

Nurter cf Surfaces: 1 

Sector Interieave Offset: 3 

| du ami m 

Disk type: 3 
Sectors/Track on TRE 2, Side 4: 16 


Sectors/Track: -28 


ting on drive /D1 
)a n. (rol, -or a (quit) 


n 


ame: Jim s Disk 


(track numbers displayed here) 
GOOD SECTOR COUNT = $2860 


OSS: 


Netice that the the user typed in was the “FORMAT /D1" command, 
the Y telling forrat that the user was ready, and the disk nare- 


- 
i 


Jjim’s Disk . 


ONE USER 
Pa 
N 


Display free srace remaining on mass-storege device. FREE 
Syntax: FREE <devname> 


This. command displays the number of unused Z56-byte sectors on a 
device which are available for new files or for expanding 
existing files. The device name given must be that of a mass- 
storage multifile device. : | 


Data sectors are allocated in groups called "clusters". The 
number of sectors per cluster depends on the stcrage capacity anc 
thysical characteristics cf ihe specific device. This means that 
srall amounts of free space may not te divisitle into as many 
files. For. example, if a given disk system uses B sectors rer 
cluster, and a free command snows 22 sectors free, a maximum of 
four new files could be created even if each nas only one 
cluster. | 


| 
Example: 


OSS: free 


£O 


BACKUP DATA DISK created on: 8¢/06/12 
Capacity: 1,222 sectors (i-sector clusters) 
1,220 free sectors, largest blcox 325 sectors 


OSS: free /D1 


OS-9 Documentation Disk created on: 81/24/13 

Capacity: 1,222 sectors (i-sectcr clusters) 

s68| Free sectors, largest blocx 440 sectors 
_ OSes: 
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Abort a process. 2x PR KILL. 


Syntax: KILL &rprocID» 


This shell "tuilt in” ccmmand sends an “abort signal to the 


process having the process ID number specified. The process must 
exist and have your user ID. The procs command can te used to 
ebtain the process ID numbers of all of your processes. 


NOTE: If a process is waiting fcr I/O, it may not die until it 
completes the current I/O operation. | 


ID Pty State Primary Module 
2 @ active Shell 

1 0 waiting Sysgo 

Z @ sleeping Copy 


active Shell 
waiting Sysgo 


ve 


08-9 LEVEL CNE USER'S GUILE 
System Command Descriptions 
Lock module into memory X | a LINK 


Syntax: LINX <memcry module name> 


This command is used to “lock” a module into memory. The link 
count of the module specified is incremented ty one. To unlock 
a module from memory, see the UNLINE Pom qur 


| Examples: 


OSS: LINK edit 


OSS: LINK myprogram 
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CS-9 LEVEL CNE USER'S GUILDE 
STAN Command Descriptions 
List the contents of e tert tite. | wo LISI 


Syntax: LIST «path? 1 <path> } 


. This command copies text lines from the input cath(s) Specifiec 


tc the standard cutput eth. The program terminates upor 


Teaching the end-of-file of the last input. patn. If more than 


one path is specified, the first path will be copied to standará 
output, the second path, etc. This is a ccnvienent method of 
forming a rrint queue. | | 


Examples: | 
list /d9/startup >/P & C (cutput is redirected to prirter) 
list /Di/userS/document /d@/myfile | /a2/Bod/text 


list /TERM »/» (copy keyboard to printer ~ use | 
| escape key to terminate input) 


S9: tuild animals 
cat 

COW 

dog 

elephant 

bird. 

fish 


eoe e €39 on ox) 


OS9: list animals 
cat 

COW 

doz 

elephant 

bird 

fish 


OS9: 
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System Command Descriptions 
5 
Load module(s) into memory. v. y TE 


Syntax: LOAD «path? 


The file specified is opened and ore or more modules is read from 
it and loaded into remory. The names of the modules are added to 


the module directory. If a module is loaded that has the same - 


name and type as a module already in memory, the module having 
the highest revision level is kept. : 


Example: 


. load new program 


OSS:mdir 
Module Directory at 13:36:47 


DCR4 Dg Di D2 po 
OSSP2 INIT OSS IOMAN “RSF 
SCF ACIA TERM TQ IZ 
Ta P PIA CDS Hi 
Sysgo Clocx a Shell "| $fsmon Copy 
Mdir 


OS9:1cad edit 
OSSemdir 


Module Directory at 13:37:14 


DCB4 DC D1 D2 DZ 
OSSP2 INIT OSS IOMAN R3F 
Scr ACTA TERM iat TZ 
To P PIA CI SHL 
Sysgo Clccz Shell "smog Copy. 
Mdir - EDIT i 


0S9: 


CS-6 LEVEL ONE USER'S GUIDE 
System Command. Descripticns 
Log user into syster. EE G a 40x LOGIN 


Syntax: LOGIN 


This program asks fcr a user name and password, which is checked 
against a validation file. If the information is correct, the 
user’s system priority, user ID, and working directories are set 
up according to information stored in the file, and the initial 
program specified in the password file is executed (usually 

HELL). If the user cannot supply a correct user name and 
password after three attempts, the process 15 aborted. 


The validation file is called “PASSWORD” and must te present in a 
directory called /D@/SYS . The file contains one or more 
variable-length text records, one for each user name. Each 
record has the follcwing fields, which are delimited ty commas: 


i. User name (up to Z2 characters, may include spaces) If 
omitted, anything will ratch. ! 


Password. (up to 32 characters, may include spaces) If 


2. 
oritted, no password will te requested 


2. User ID number: must be uniquely assigned from 2 to 65525. 
This is the numter used ty the file security system. j 
&. Initial process priority: 1 ~ er | 

S£. Pathlist of initial execution directory. 

€. Pathlist of initial data directory. 


2. Name of initial rrogram to execute (usually "shell J. 
— NOTE: This is not a shell command line. 


Here's à sample validation file: | 


CSO9: DIR /D£/SYS 
Directory of /DO/SYS 13:22:18 


| PASSWORD 


089: LIST /DC/SYS/PASSWCRD 
21,128, /2€/CMDS,.,SEELL. 


8A81C,,4,120,/D0/CVDS ,/D1/BASLIB, SHELL BASICS ; EX SHELL 
BOB,guess who,14,120,/T0/:08 CMDS,/D1/3C025 DI2,RATSGAME 
T 


SUE,notody knows it,4,256,/G2/CMD5, . , SHELL 
KEN,xing of Microware,s,255,/d0/cmds,.,sheli 


(089: 
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System Command rescripticns 


LOGIN (continued) 


To use the login command, you may simply type “LOGIN” as shown 
below: 


login 


This will cause the login promts to te printed, and if answered 
correctly log you into the system. It will set ycur user number, 
working execution directory, working data directory, and execute 
jour initial rrcgrar. Note: if the original. incarnation of the 
shell will not be needed again, it may be discarded by using the 
EX command to start the LOGIN command. For example: 


ex login 


Pt Logging Off ihe Sys tem 


To log off the system, the initial program specified in the 
vassword file must te terminated. For most programs (including 
Shell) this may te done by typing an end cf pope character 
(escape) as the first character on a line. 


e 


S-9 Level 1 Timeshering System | Level 1 V1.2 91/24/17 


"ser name?: KEN 
Password: xing of Microware 


Process 507 logged 31/24/17 14:14:53 
Welcome! 


O39: 
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Make a new directory file. E | MAKDIR 


Syntax: MAKDIR <path> 


Creates à new directory file according to the pathlist given. The 
rathlist must refer te a parent directory for which the user has 
write permission. The new directory is initialized ard linked te 


(is parent directory. All access permissions are enatled (except 


Sharatle). 
*xamples: 


makdir /di/old_dir/new_dir (creates new dir) 


makdir zép (working directory is parent directory) 
OSS9:DIR 
Lirectory of 13:57:49 


CMDS DATA 


“OSS:MAKDIR my directory 
OSS:DIR 


Directory of 


CMDS DATA my ilrectory 


OS9schd my directory. 
OSE:build myfile 


? Put some text in a file 
4 yai 


OSS:dir 


Directory of . 14:82:25 
myfile j 


OSS*chd i+ 
OSO:dir 


Directory of . 
-CMDS | DATE 


0S9: 


(C) 19829,1981 MICROWARZ SYSTIMS CORPORATION PAGE ZZ 


Display module directory. Tib | | OM LIT 


=: Syntax: MDIR [e] 


Disrlays tne present mcdule names in the system module directory, 
i.e., all modules currently resident in memory. 


If the "e" option is given, a full listing of the address, size, 
type, revision level, and user count of each module is displayed. 


All numbers shown are in hexadecimal. 


WARNING: not all modules listed ov MDIR are executable.as 


processes: always check the module type code tefore executing 4 
module if you are rot familiar with it. | 


Example: 
OSS:mdir 
Module Directory at 14:44: 35 . 

DCB4 Dg D1 De D3 
OS9PZ INIT 059 ICMAN - RBI 
SCF ACIA TERM TE 4 T2" 

S | P PIA CDs Hi 
Sysgo Clock Shell . Tsmon Mair 


(C) 19830,1981 MICROWARE SYSTEMS CORPORATION ^ o PAGE. 6€ 


08-9 LEVEL ONE USER'S GUIDE 
system Command Descriptions 
K B . Merge files to standard outzut ` ~ Y MZRGI. 


Syntax: MERGE <path> { «path» ) 


This command is used to copy the path(s) specified the standard 
output path. It is similar to the list command, however. MIRAGE 
'" does no output line editing (such as automatic line feed). The 

standard outrut path is generally redirected to a file or device. 

Examples: 


RGE myfile >/newfile (acts like a copy) 


RGE filel file2 filez file4 
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oystem Command Descriptions 
List free memory areas. l i NHH KT | 


syntax: MFREE [e] 


Disrlays a list. of which areas of memory are available fcr 
assignment. The address and size (number of 256-tyte pages) of 
each hole is listed. The addresses are shown in hexadecimal and 
the sizes in decimal. | "a | 


Frample: 


OSS :mf ree 


720- "FF 1 
BEG-AEFE 164 
8100-81FF 1 


Total rages free. - 166 


C2 
Drt" 
p 
LO 
OG 
C 
t- 
LO 
0B 
t 
<< 

E Len! E 
ca 
sx) 
|1Q 
TN 
+o 
[pHC 
th 

" aan 
Ca 
3 
tea 
a 
C2 
“C2 
3 
EO 
© 
n) 
P 
+} 
RA 
© 
a 
ryj 
i> 
G2 
td 
Oo 
^ 


e atv TIO ui i = 
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System Command Descriptions 


Build a new toot file and install it on a device. .. OSSGEN 


Syntax: OSSGEN /<device name> 


This soma is used when it is necessary to tbtuild a new toot 
file that includes modules not in the existing bcot (the COBBLER 
command should te used to make a mirror image of the current 
boot). The OS9GEN command creates a new file called "TzMPzOOT', 
read a series cf pathlists from standard input-and includes each 
of these files in TEMPBOOT (each pathlist should te on a separate 
line), and then installs. TEMPBOOT as the new boot file and 
renames it to Boot. . After all the necessary files have been 
included in the boot, an end of file character (escape) should be 
entered as the first character on the next line. The standard 
input path is normally redirected tc a file so that the the 
pathlists may be reed from it. | | 


WARNING: CSSGEN cen te a Dangerous command, by generating a file 
that doesn’t have all the modules required to tootstrap. For 
this reason, it is recommended that you build a file containing 
the names of all files to te included in the boot. Then redirect 
OSSGENS input to thet file 


NOTE: The toot file must be contiguous. For this reason, new 
boot files are normelly installed cn a freshly formatted disk. 


Examples: 


os9gen </d@/myfile /D1 (pathlists read from “myfile } 


osSgen /E9 


OS9:0sSgen /di 


osSfile 
hardware | 
my program 
| (escape key 1s first character) 


OSG: 
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Print errors in Fnlish | Us) S SIC PRINTERS 


Syntax: PRINTERR 


This command replaces the standard F$PERR service request with 
one that displays OS-9 error messages in Enzlish instead of 
displaying an error number. After this command has been 
Em the system will continue to print. error messages ir 
English. | | | | | 


For this command to work, a file called "/DO/SYS/ERRMSG" must 
exist on DØ. A sample ERRMSG file is Shown below, it. only 
contains four error messages. Each line bezirs with an error 
number (decimal), followed by e space character. The rest of the 
line will be displayed when that error occurs. 


1 - UNCONDITIONAL ABORT 

13 -—- I-Code Overflow. 

Z — Keyboard Abort 

14 -- Illegal Channel Reference 


Notice that the error numbers do not have to be in order. ‘The 
PRINTERR command will automatically search the file for the 
apporpriate error number. 


WARNING: Once the yrinterr command has teen used, it can not be 

un-done. Also the disk in drive zero should nct be removed at any 
time an error might occur. Also the ERRMSG file must exist wher 
an error occurs or the system may crash. Once installed, the 

PRINTERR module  shculi not. be  unli{sxed. PRINTERR uses the 

current user's stack for an I/O buffer, so users are encouraged 
to reserve reasonably large stacks. 


NES USER S GUIDI 
nd Descriptions 


ETN l "A 

L ! Display procedures and ‘their status. eru PROCS 
Syntax: PROCS [e] 
Generates a listing of the processes presently in existance. . If 
the | € option is used all processes in the system are listed, 
otherwise only those having the caller's user Pie 

The process ID number, status, priority, and primary program 

rodule is given for each process. | 
The status shown is a "snapshot" taken at the instant the command 
is executed: processes can switch states rapidly, sometimes 
several times per second. The priority is the value used ty the 
CS-¢ CFU scheduler to determine the length and frequency of the 
process’ time slice. The primary module is the name of the 
program the process initially executed when it was invoked. All 
numbers displayed are decimal. 
Example: 


OSS:rroecs 


Primary Module 


no sie air ee ome m on om Au at GUMD pt ger OOD quip WUND e Kar r ENED r m 


Ka 
ty 
ta 1 rO 
| cr 
d 

Un 

ct 

w 

et 

(D 


| 7 128. activa kdit 
8 43 active Fasic¢s 
2 active Basico 
2 158 waiting Shell 
1 1 waiting Sysao 
4 Ø sleeping Tsmon 
5 Ø sleeping Tsmon. 
6 € sleeping Tsmon 
Joes 
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Change file name. | EET E ER 2o ei 
Syntax: RENAME <path> (new name> 


Gives the mass storage file specified in the pathlist a new name. 
The user must have write permission for the file to change its 
name. It is not possible to rename . Cree | | 


Examples: 
rename blue purple 


rename /D3/user9/test temp 


|. QS23:dir 


Directory of . 16:22:53 
myfile animals 


CSS:rename animals cars 
OSS:dir 


Directory of . 16:23:22 
myfile- cars 


OSS: 
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E USE 
System Command Descriptions 


ret 


Copy memory module(s) into a file. X. ] (Ve me S RV 
Syntax: SAVE <path> <modname> {<medname>} 


Creates a new file and writes a copy of tae memory a 
scecified on to the file. The module name(s) must exist in the 


module directory when saved. The new file is given access 


permissions for all modes except public write. 
‘Note: SAVES’s default directory is the current data directory. | 
Executable modules. snould generally te saved in the default 
execution directory. 


Examples: 


save wordcount wccunt 
save math rack add sub mul div 


QSS:save /AVmyfile E 
OSS: 


€» 
"x 
"dj 
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System Command Descriptions 
Activate and set system clock. | | SETIME 


Syntax: SETIME [y,r,d,h,m,s] 


This command “asks for or inputs the date and time, then 

activates the real time clock. The numbers are one or two digit 
decimal using space, colon, semicolon or slash delimiters. If the 
time is not given in the command line setime will print a prompt 
requesting the data. The hours are based upon a 24 nour clock, 
i.e., 15:20 is 9:20 PM. gv | 


IMPORTANT NOTE: This command must be executed before OS-S can 
perform multitasking operations. If the system does not have & 
real time clock this command should still te used to set the date 

for the file system. . 


Examples: 


0S9: setime 82,6,22,14,2,2 
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System Command Descriptions 
me Go to sleep for some number cf ticks . -SLEEP 


SYNTAX <tick count> 


This service request is used to "sleep" for some number of clock 
ticks. It is generally by programs that have no other method of 


accessing the real-time clock. 


Example: 


0S9: SLEEP 25 
CSO: 
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system Command DLeserlptiorns 
Set process priority. | | | SETFR 


Syntax: SZTPR €CprocID2 (pünter? 


This command is used to set a process” priority, which is a value 
used by the OS-9 CPU time scheduler to determine the duration end 


frequency of your time slices. The id number must be of a process 


that has your user ID. 


The value is a decimal number in the range 1 to 255. 


ID Pty State Prim ary botte 


1 waiting Shell 
1 waiting Shell 
1 waiting Sysao 


KA M CH 


setrr 3 126 
procs 


Oo 
CA (4 
tO (0 


ID Fty. State Primary Module 
128 active Snell 


3 
2 t waiting Snell 
i 1 waiting Sysgo 
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System Command Descrirptiors 
05-2. command interpreter. | | SREELL 


The shell is a program th iat reads data from. its standard . input. 
rath and interprets the data as a sequence of commands. The. 
basic function of the shell is to initiate and control execution 
of other OS-S programs. 


‘The shell reads and interprets one text line et a time from the 


standard input path. After interpretation of each iine it reads 
another until an end-cf-file condition cccurs, at which time it 
terminates itself. A special case is wher the shell is called 
from another program, in which case it will taze the parameter 
area (rest of the command line) as its first line of input. If 
this command line consists cf only "built in commands, the shell 
will continue to ask for lines, otherwis control vill return to 


to calling MES T the initial comma nc line is processed. 


The rest of this description is e, _teconical specification of the 
shell syntax. Refer to the "Shell section of this guide for e 
user- “oriented discussion of how to use the shell. | 


Shell Input Line Formal Syntax: 


«zer» {<pem>} 
rams>} [ <name> [<medif>] [«pam params>] Tu ] 


Frogram Specifications 


«module rame? 
<pathlist> 
( <pem listo ) 


oo oo +o 
uou 


Perameters 


<params>:= <param> { <delim> <param> } 

<delim> := space or comma characters 

<param> := E: «nare? [<medif] chain to program specified 
<= chd <prathlist> change working directory 
f EE exreclp» send abort. signal to yrocess 
:- sSetcr<rrocID> <pty> change process” priority 
f= ChX «pathlist? change execution Glrectory 
I= Ww walt for any precess ic die 
S turn "OSS:" promoting on. 
pem owe turd e orf 
= t ecac input lines to sti. outrzut 
= t MOI oe 


o0 input iires 


<integer> 
<integer> K- 


C5 d TL 
System 
SHELL (continued) 
:= -xX 
<= X 
:= * <text> 
<sep> := j 
s= Å concurrent exe 
= I 
z= < 
Modifiers 
«modif» := <mod> { <delim> 
€mcd» := < Xpatnlist» 
‘= > c Xat) ist» 
t= >> Cpathlist> 
Z # 
- # 


n du 
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bescrictions 


EM 


don’t abort on error 
abort on error 


comment line: not processed 


sequential execution separator 


cution sezarator 


^» pirelire separator 
cr» end-of-line (sequential execution separator) 


«mod» } 

redirect standard input 

redirect standard output 
redirect standard error outcut 
set process memory size in pages 
program memory size 

1X increments 


set 
in 


CORPORATION 


NAT TO t a 
CNX USER'S GUILE 


Naat 
ommand Descriptions 


. Change terminal operating mode. z TMOLE 
Syntax: TMODE [.<patanun>] [<arglist] 


This command is used to eats or change the operating 
parameters cf the user “s terminal. Uc 


If no arguments are given, tne present values for each parameter 


- 


are displayed, otherwise, the raeremeter(s s) ziven in the argument 
list are processed. Any number cf parameters can be given, and 
are separated by speces or commas. 

* | ` 
A period and a number car be used to optionally specify. the path 
number. to te affected. If none is given it defaults to the 
Standard input peth. If this commard is p ir a shell 
procedure file, it will te necessary to use th . (path num»? 
option to specify one cf the standard output S to change the 
terrinal’s operating characteristics. this command can word 
only if a path to the file/device has already teen opened. You 
ray alter the device descriptor to set a device” s initial 
operating parameter (please see the System Programmers Manuel). 


UTC Upper case only. Low case characters are automatically 
converted tc upper c S . 

“upc. oes case and lower se characters permitted iene 

Erase on backspace: backspace characters echced as a 

tac kspscecii ace becky: ace Sequence (def ault). 


bsl page soace over line: lines ere S ty sending 
tackspace-srace-tacksrace Sequerces to erase tne same 
line (for video terminals) (default). 

-bsl No backspace over lire: lines are: deleted” by Sriti 
a “new line sequence (for nharé-cozy terminals}. 


echo Input characters “echoed” tack tc terminal (default) 
“echo No echo | 


1f Auto line feed on: line feeds aut omatically echoed to 
terminal on input and outrut carriage returns (default). 
=] f Auto line feed off. 


* pause Screen pause cr: cutpul suspen ded upon full s$ s 
rag carameter for definition of screen size. Output 
can te resured by typing any key. | 
“pause Screen| pause mode of ft. 


null=n eat Sane number c? null ($£0) caaracters 
| transmitted after carriase returns for return delay. 
The numter is decimal. 
default - £. 


ar 
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TMODE (continued) 


Q 
| d 
E 
fu 
ts 
ee 
in 
t 
lei 
(0 
Ln 
LI 


 ragsn Set video display cage lengta to r (deci 
Used for pause mode, see abcve. 


bsp=h Set inrut backspace character. Numeric value of 
character in hexadecimal. 
Default = 58. 


bse=h Set output backspace character. Numeric value of 
character in hexadecimal. 
- Default = go. 


del=h Set input delete lin e character. Numeric value of 
cheracter in hexadecimal. 
Default = 18. 


bell=h Set tell (alert) output character. Numeric value of 
character in hexadecimal. 


Default = 27. 


l : . 
eor=h Set ená-cf-recorà (carriage return) input character. 


Numeric 
Default = 


value of character in hexadecimal. 


ZL 


eof=h Set end-cf-file input charac ster.” Numeric vaiue of 


Cheracter 
Default = 


ir hezadecimel. 
LE. 


type=n ACIA- initialization value: sets parity, Werd«sizey etc. 
Value in nexadecimal. © | 
Default = 18 (should almost never te changed) 


reprint =h Reprint line character.  Mureric value cf character 
| ir hexadecimal. | 


dup=h Duplicate lest input line character. Numeric value of 
character ir hexedecimel. 


esc=h Pause character. Numeric value of character in 
hexadecimal. 


ort=h Abort character (normally control C). Numeric value 
of character in hexadecimal. 
quit=h Quit character (normally control C). Numeric value 


rect 
of character in hexadecimal. 


C2 
neat” 
KA 
t6 
0» 
[9] 
t 
LO 
[ev 
te 
<< 

* 
C2 
nud 
Oo 
15 
ey} 
i+} 
in 
rs 
Ui 
LJ 
1-1 
< 
Ci 
C3 
C5 
A f 
YO 
© 
L) 
he 
ry 
4 
© 
= 
MS) 
M» 
G2 
taf 
n 
H 
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TMODE (continued) 


tmode -upc. 1f null=4 tse=1F pause 

tmode pag=c4 pause bsl -echo tsp-8 tsl=C 

tmode .@ -echo ` f (turn echo off on standard input) 
NOTE: If you use TMODE in a procedure file, it will be necessary 
to specify one cf the standard output paths (.1 or .2) since tne 


shell’s standard input path will have been redirected to the disk 
file (TMODF can not be used on an SCFMAN-tzpe devices only). 


(set lines/page on standard output) 


CS-S LEVEL ONE USER“S GUIDE 
System. Command Descriptions 
Timesharing terminal monitor. | = TSNCN 


r 
i 


Syntax: TSMON. [<patalist>? 


This command is used to monitor idle terminals in timesharing 
applications. If a pathlist is given, standard I/O patas are 


opened for the device, When a carriage return is typed, a FORK” 
is performed to the LCGIN command. If the login fails because 
the user could nct supply a valid user name or password, LOGIN 


will return to TSMON. 


Nete: The LOGIN comraná and its password file must be present for 
TSMON to. WotR. correctly (please see the LOGIN command 
description). elo | 


logging Off the System 

Most programs will terminate when an end of file character 
(escape) is entered as the first character on a command line. 
This will log you off of the system and return control to TSMON. 


TFxamples: 


E 


OS-9 LEVEL ONE USER“S-GUITE 
System Command Lescricticnas 
Release memory module. EC MELDEN UNLINK 


Syntax: UNLINS «modname» { <modname>} 


Tells OS-¢ that the memory module(s) named are no longer needed 
ty the user. The module(s) may or may not be destroyed and their 
memory reassigned, depending on if in use by other processes or 
user, whether resident ir ROM or RAM, etc. 


Ito is ood practice to unload modules whenever soberbia to make 
most eff qo. use cf available memory Tescurces. - : 


E 


Warning: never unlizx e module you did not Load or link to. 


Fxample: 


unlink pemt pgm5 remg¢ 


x 


OS9t:mdir 


Module Director; at 1 


1:26:22 
DC 24 DG D 1 D2 LS 
OSSP2 INIT OSs I OMAN RBE 
SCF ACIA TERM T1 B 
Te | P PTs Sysgo Clock 
Shell Tsmon Edit 


OSS an edit 
OS9:mdir 


Module Directory at 11:26: 22 


DCR4 D2 D1 de DZ 
OSSP2 INIT OSS IOMAN RIF 
SCF ACIA TERM TL TS 
TE. P PIA Sysgo Clecs 
Shell Ts ron 

059: 
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Verify module(s) | | B uf VERIFY. . 


This commend is used tc verify that a module’s header parity and 


CRC values match those computed. ty the verify command. The 
rodule(s) are read from stan idard input and the updated module(s) 


are written to standard output. Messages will be sent to-the 


standard. error rath. 


If the U (update) ortion is specified, the module(s) will te 
ccpied to the standard output path with the modules header 
parity and CRC values replaced with the computed values. A 


message will te disrlayed to indicate whether or not tne module" S 


values matched those computed by VERIFY. 


If the option is NOT specified, the module will not be copied to 
standard output. VERIFY will only display a message to indicate 
whether or not the module’s header perit, and CRC matched  tnose 
which were computed. i 


Examples: 


OSO:verify <EDIT ONEWEDIT 


Modules header parity is correct. 
Calculated CRC matcnes moule s. 


[ Y. if; mvo i woro2r i 
OSO:verify <myprogrami >myrrogramz 


Moáule's header parity is correct. 
CRC does not match. | 


OS9:verify <myprogram2 -~U 


Module/s header parity is correct. 
Calculated CRC matches mcdule’s. 


OSs 


t) 


* 
e 
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COMMAND SUMMARY 


ATTR <path> {<orts>} 

BACKUP [ <devnare> [ <devname> ]] 
BUILD <path> | 

CHD <path> 

CHX <path> 

COBBLER /<device rame? 

COPY <path> <path> 

DATE [t] 

DEL <path> 


. DIR [<path>] 


DUMP <path- 
ECHO «text»? 
EX <arglist> 


FORMAT <devname> [<options>] 
FREE <devname> 
KILL <procID> 


LINK «module» 


LIST <path> 

LOAD <path> 

LOGIN 

MAKDIR <path> 

MDIR [e] 

MERGE <path> («path») 
MERE 

OSOGEN 


P 
PROCS 


RENAME <path> <new name> 


SAVE <path> (<modname>] {<modname>} 


SETIME (<y,m,a,h,m,5>] 


SLEEP <tick count> 


SETPR <procID> <number> * 
SHELL [<arglist>] 
T : 


.TMODE [<arglist>] 


TSMON [<devnam>] 


JUNLINK <modname> { <modname>} 


VERIFY [u] 
Y 


X 
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- gà 
3 
ae 
pa de 
ea 


Set file attributes 

Backup media | 

Cepy std. input to file 
Change data directory 
Change execution directory 
Install beot cn device 
Copy path to path 

Display date (opt. time) 
Delete file 


List names in directory 


Rinary dump of file 

Echo input text to output. 
Execute program (and 
discard shell) 

Initialize media. 

Lisplay free space size 
Abort process 

Lock moduie into memory 
Display text file 

Load module(s) into memory 
Log user irto system 
Create new directory 
Display module directory 
Merge files (to output) 
Disvlay free memory size 
Build new toot file 

Turn shell prompts on/off 
Show processes and status 


Change file name 


Save memory rodule(s) 
on file . 


|» áctivete and set 


system c lock | 
Sleep fer a time interval 
Change rrocess priority 
Command interpreter 

Copy shell input 

to output 


Disvlay/set terminal 


rarameters 


- Timesanaring idle process 


Release memory modules | 
Verify module(s) 

Wait for any. 

process to die 
Abort shell on errer 
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Arpendix.A : Command Summary 
OTHER OS-9 PROGRAMS 
basics [<path>] | -BASICOS 
debug Di interactive detugger 
edit [<path> [<path>] ] | macro text editor 


styl [<path> [<path>] ] Stylograph word processor 


NOTE: The commands marked with a '"*' are shell built in commands 
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Appendix B : 05-9 Error Codes 


OS-S ERROR CODES. 


the error codes are shown in a tR hexadecimal (first column) and 


decimal 


(second column). Trror codes other than those listed 


are generated ty PRenronmrug languages or user programs. 


HEX DEC 
469 200 
&c9 281 
SCA 202 
CB 203 
sec 204 
5CD 295 
SCE 226 
SCF 207 
¿DØ 208 
D1 209 


$06 214 


SLT 215 


(C) 1989, 


PATH TABLE FULL - The file cannot te opened because 
the syster path tatle is currently full. 


ILLEGAL PATH NUMBER - Number too large or for 
non-existant path. 


INTERRUPT POLLING TABLE FULL 


ILLEGAL DEVICE - Can’ t find device descriptor, 


file manager or device driver. 
DEVICE TAELE FULL - Can't add another device. 


ILLEGAL MCDULE HEADER - Module'/s sync code, check 
character or CRC is incorrect. 


MODULE DIRECTORY FULL - Can’t add another module 


MEMORY FUIL - Not enough contiguous RAM 
avallable to process request. 


ILLEGAL SERVICE REQUEST - System call nad an 


illegal ccde numter. 


MODULX 3USY E non-sharatle module is in use ty 
anc ther process. 


20UNDAR (Y ERROR - Memcry allocation or deailocation 
request not on page toundary. 


END OF FILE - End of file encountered on read. 


NOT YOUR MEMORY - attempted to deallocete memory 
not previcusly assigned. 


NON-zXISTING SEGMZNT - e T TT file. 
structure. 


NO PERMISSION - you don’t have owner’s permission. 
to access the file as recuested. 


BAD PATH NAME — syntax error in pathlist. 


"d 
in 
ça 
ri 
tas 
i 
p 
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03-9 ERROR CODES (continued) 


ux he 
&D8 216 
sng 217 
$54 218 
¿DR 219 
$DC 222 
$DD 221 


SDF «gee 
SLO 224 
Sal 225 
$E2 226 


I4 228 
$E5 229 
Ye 250 
$E? 221 


^(C) 1980, 


A 


MISSING PATELIST - expected pathlist missing or | 
in error. 


SEGMENT LIST FULL - file is too fragmented to. 
be expanded further. 


FILE ALREADY EXISTS - file name already appears 
in current directory. | 


ILLEGAL BLOCK ADDRFSS - device's file structure 
has been damaged. ; 


ILLEGAL BLOCK SIZE - device’s file structure 
has teen damaged. | 


MODULE NOT FOUND - request fcr link to module 
not found in directory. | 


SECTOR OUT OF RANGE - device file structure 
damaged or incorrectly formatted. : 


SUICIDE ATTEMPT - request to return memory 
woere your stack is located. 


ILLEGAL PROCESS NUMBER - re such process 
exists. 


ILLEGAL SIGNAL COLE. 


NO CHILDREN - can’t wait because process 
has no children. : 


ILLEGAL SWI CODE - must be 1 to 7. 


KEYZOARD ABORT - process aborted by 
signal code 2. 


PR L0CESS TABLE FULL - can ^t forz now. 


ILLEGAL PARAMETER AR pius high and low bounds 


passed in fork call are incorrect. 


BACKTRACE ERROR - you'll never see this one. 
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Appendix B.: . 05-9. Errcr Codes 


OS-9 ERROR CODES (continued) 


epg 224 SIGNAL ERROR - receiving process has previous 


- DEVICE 


unprocessed Signal pending. 


DRIVER/HARDWARE ERRORS —- 


$79 242 UNIT ERROR - device unit does not exist. 


871 241 SECTOR ERROR - sector number is out of range. 


5F2 242 WRITE PROTECT - device is write protected. 


$F3 2438 CRC 


ERROR - CRC error on read cr write verify. 


$F4 244 READ ERROR - Data transfer error during disk read 


operation. 


¿F5 245 WRITE ERROR - hardware error during disk - 


write operation. 


$P6° 246 NOT 


READY - device has "not ready" status. 


< 0 $87 247 SEEK ERROR - physical seek to non-existent sector. 


éF8 248 MEDIA FULL - insufficient free space cn media. 


SFG 249 WRONG TYPE - attempt to read incompatible media (i.e. 
attempt tc read doutle-side disx on single-side drive) 
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